home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / tutor / s3bas11.arj / SDV12.DOC < prev    next >
Text File  |  1992-11-22  |  11KB  |  280 lines
  1. Program:        S3 Doc View Utility
  2. Version:        1.2
  3. Author:         George Spafford
  4. Date:           05/26/92
  5.  
  6. Purpose:
  7.  
  8. To provide a simple ASCII file browsing utility at a low price to
  9. users and program developers.
  10.  
  11. SDV will only operate on DOS versions 3.3 and above.
  12.  
  13. OutLine:
  14.  
  15.         I.      Starting the  Program
  16.                 A.      Single File
  17.                 B.      Using the File Menu
  18.         II.     File Menu System
  19.                 A.      How to get Help
  20.                 B.      Command Summary
  21.                 C.      Changing File Attributes
  22.                 D.      Copying a File
  23.                 E.      Deleting a File
  24.                 F.      Editing a File
  25.                 G.      Information on a File
  26.                 H.      Moving a File
  27.                 I.      Printing a File
  28.                 J.      Renaming a File
  29.                 K.      System Information
  30.                 L.      Shelling to DOS
  31.         III.    Viewing a File
  32.                 A.      How to get Help
  33.                 B.      Command Summary
  34.                 C.      How to print a screen
  35.                 D.      How to search for text
  36.                 E.      Repeating the last search
  37.                 F.      Shelling to DOS
  38.         IV.     How to Register this Program
  39.  
  40.  
  41. I.      Starting the Program
  42.  
  43.         SDV can be invoked either with a filename to view a single file or
  44.         it can be invoked without a filename to bring up all files that are
  45.         in the current subdirectory.  With this in mind, SDV should either
  46.         be in the current directory or in directory that is contained in your
  47.         PATH statement.
  48.  
  49.         A.      Single File
  50.  
  51.                 SDV myfile.txt          <- this will only read myfile.txt
  52.  
  53.                 myfile.txt is the name of the single file that you want to read.
  54.  
  55.         B.      Using the File Menu
  56.  
  57.                 SDV                     <- this will start SDV and use the menu
  58.  
  59.                 Use the arrow, home or end keys to move around in the menu.
  60.                 While in this menu, a number of options are available to you.
  61.                 ESC will back you up one menu each time that you press it.
  62.                 
  63. II.     File Menu System
  64.  
  65.         A.      A help screen that summarizes the command keys can be pulled
  66.                 up at any time by pressing the F1 key,
  67.  
  68.         B.      Command Summary
  69.  
  70.                 F1      Help
  71.                 F10     Shell to DOS
  72.                 A       Change File Attributes
  73.                 C       Copy a File
  74.                 D       Delete a File
  75.                 E       Edit a File
  76.                 I       File Information
  77.                 M       Move a File
  78.                 P       Print a File
  79.                 R       Rename a File
  80.                 S       System Information
  81.  
  82.         C.      Change File Attributes
  83.  
  84.                 While you have the desired file highlighted, press the
  85.                 letter "A" and then select the attribute that you wish
  86.                 to add to the file or "C" from the attribute menu to clear
  87.                 all attributes.
  88.  
  89.         D.      Copying a File
  90.  
  91.                 While you have the desired file highlighted, press the
  92.                 letter "C" and then designate the target directory that
  93.                 you want the file to go to.  Attributes will not be copied.
  94.  
  95.         E.      Deleting a File
  96.  
  97.                 While you have the desired file highlighted, press the
  98.                 letter "D" and then confirm the request.  Note, this will
  99.                 delete any file regardless of its attribute.
  100.  
  101.         F.      Editing a File
  102.  
  103.                 While you have the desired file highlighted, press the
  104.                 letter "E" to edit it.  By default, the DOS EDIT program
  105.                 is used.  You can specify your own editor by making a .BAT
  106.                 file called MYEDIT.BAT containing the name of your editor,
  107.                 the environment variable %1 which will be passed the name of
  108.                 the file to edit and then any command line options that you need.
  109.                 For example:
  110.                     QEDIT %1
  111.                 SDV will look for MYEDIT.BAT in the current directory or it will
  112.                 search the PATH.
  113.  
  114.         F.      Information on a File
  115.  
  116.                 While you have the desired file highlighted, press the
  117.                 letter "I" to get the file date, time, size and attributes.
  118.  
  119.         G.      Moving a File
  120.  
  121.                 While you have the desired file highlighted, press the
  122.                 letter "M" and designate the target directory.  Note,
  123.                 attributes do not transfer and the original file will be
  124.                 deleted regardless of its attribute.
  125.  
  126.         H.      Printing a File
  127.  
  128.                 While you have the desired file highlighted, press the
  129.                 letter "P."  The file will print to LPT1 using the file's
  130.                 formatting.  At this time, SDV will not affect any changes
  131.                 to the pagination, box codes, etc.
  132.  
  133.         I.      Renaming a File
  134.  
  135.                 While you have the desired file highlighted, press the
  136.                 letter "R" and designate the new file name.  Note, the
  137.                 original file's attribute WILL be carried to the new file.
  138.  
  139.         J.      System Information
  140.  
  141.                 From anywhere in the file menu, press the letter "S" to bring
  142.                 up a summary of the system.  This summary includes:
  143.                         CPU class
  144.                         If there is a math coprocessor
  145.                         Number of Floppies
  146.                         Number of Com ports
  147.                         Number of parallel ports
  148.                         The DOS version
  149.                         If SHARE is loaded
  150.                         The active drive
  151.                         Size of the active drive
  152.                         Remaining space on the active drive
  153.                         If it is a network drive
  154.                         Type of video subsystem
  155.  
  156.         K.      From anywhere in the file menu, press F10 to shell to DOS.
  157.                 To return from the SHELL, type EXIT on the command line and
  158.                 then press <ENTER> to return.
  159.  
  160. III.    Viewing a File
  161.  
  162.         If you are using the file menu to move around, select the name of
  163.         the file that you want to browse and press <ENTER>.  If you are
  164.         using a single file name, you are already here!
  165.  
  166.         Use the arrow, page up, page down, tab, shift-tab, home and end
  167.         keys to move around.  ESC will return to the file menu if you used
  168.         it or to DOS if you speicifed only a single file.
  169.  
  170.         A.      How to get Help
  171.  
  172.                 Press F1 at any time to get a summary of the commands
  173.                 available while in the viewing module.
  174.  
  175.         B.      P       Print Screen
  176.                 S       Initial Search
  177.                 F1      Help
  178.                 F3      Search Again
  179.                 F10     Shell to DOS
  180.  
  181.         C.      How to print a screen
  182.  
  183.                 While you are viewing the desired information, press the
  184.                 letter "P".  This will print all of the text, but avoid the
  185.                 header and footer lines that SDV displays.
  186.  
  187.  
  188.      NOTE:  The search function does not operate correctly yet, please avoid
  189.         |   using it and associated functions.
  190.         |
  191.         ---------------------------------------------|
  192.         D.      How to search for text   <-----------|
  193.  
  194.                 To perform the initial search, press the letter "S" and then
  195.                 enter your search text.  The search process itself is case
  196.                 insensitive.  The search will start from the beginning of the
  197.                 file and will end at the end of the file.
  198.  
  199.         E.      Search Again
  200.  
  201.                 Push F3 if you want to continue searching for items specified
  202.                 using "S".  F3 will pick up where "S" left off.  "S" forces the
  203.                 search to begin at the start of the file.
  204.  
  205.         F.      Shelling to DOS
  206.  
  207.                 At any time while in the view module, you may push F10 to shell
  208.                 to DOS.  To return, enter EXIT at the command line.
  209.  
  210.  
  211.         ============================
  212. IV.     Please Register This Program
  213.         ============================
  214.  
  215. "SDV" and "S3 DOC VIEWER" are CopyRights of George Spafford All Rights Reserved.
  216.  
  217. SDV is distributed as SHAREWARE.  It is not Public Domain.
  218. If you find that this program aids you in your work, it should be
  219. registered within 30 days of your first usage of it.  If you are an
  220. end user, and want to use this for your personal use, it is $5 for
  221. each concurrently used copy meaning that for $5 you can only use it on
  222. one (1) PC at a time.
  223.      
  224. If you are a program developer and wish to distribute SDV with your
  225. program to aid your users in reading your ASCII files, SDV can be
  226. licensed for you to distribute an unlimited number of copies for 
  227. a one-time fee of $20 per each application that you intend to release SDV with.
  228. With this, you are entitled to use new versions as they are released to the
  229. public on BBS systems.  Once SDV reaches your end-users, this distribution
  230. license terminates.  In other words, when they get the program, your
  231. distribution rights do not transfer with it.  If they are going to bundle it
  232. with a program of their own, they must register SDV with me in order to
  233. distribute the program.
  234.  
  235. History:
  236.  
  237. v1.2    05/26/92
  238.  
  239.         Whew....
  240.         -       File menu system
  241.         -       Text searches
  242.         -       Line Numbers
  243.         -       Printing
  244.  
  245. v1.1    03/26/92
  246.  
  247.         Increased the internal buffering & added the line number display
  248.         as well as the EOF indicator. <Never Released Due to Bugs>
  249.  
  250. v1.0    03/25/92
  251.  
  252.         Initial Release.
  253.  
  254. Registration of this product will allow me to continue developing
  255. specialized software for you, the consumer, at shareware prices.
  256. Payments (please do not send cash) can be sent to:
  257.  
  258.           George Spafford
  259.           3001 Lakeshore Drive, #329
  260.           St. Joseph, MI 49085
  261.     
  262. Queued Access BBS 19200-8-N-1 ANSI (616) 468-5026  FIDOnet 1:2340/0
  263.               Sysop:  Tim Akright NEC/NC
  264.               
  265.  
  266. SHAREWARE DISTRIBUTORS:
  267.  
  268. You may distribute this program as long as it is made clear that you are
  269. only a distributor and that the program is not registered until they make
  270. payment to me.  Please do not charge more than $5 per disk to distribute 
  271. SDV to your customers.
  272.  
  273. ::::: Legal :::::
  274.      
  275. SDV IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES
  276. NO WARRANTIES OF APPROPRIATENESS, MERCHANTABILITY OR FITNESS FOR A
  277. PARTICULAR PURPOSE.  THE AUTHOR ASSUMES NO LIABILITY FOR ANY DAMAGES
  278. (INCLUDING LOST PROFITS, WAGES OR ANY OTHER CONSEQUENTIAL OR INCIDENTAL
  279. DAMAGES) ARISING OUT OF THE MISUSE OR INABILITY TO USE THIS PRODUCT.
  280.